home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu178.dms / pu178.adf / DOCUMENTATION / OTHERS / Arq.doc < prev    next >
Text File  |  1994-11-01  |  10KB  |  436 lines
  1.  
  2.  
  3.      Page 1                         Arq                         Page 1
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                                     Arq
  22.       Copyright © 1990,91 by Martin Laubach, Peter Wlcek and René Hexel
  23.                             All rights reserved
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.      Page 2                         Arq                         Page 2
  66.  
  67.  
  68.  
  69.   1. Introduction      
  70.  
  71.        Arghh! There it is again... My favorite application just
  72.      wanted to inform me of some important event. And there it
  73.      appears, the much-hated standard system requester, that
  74.      itty-bitty window that seems glued forever to the upper left
  75.      edge of the screen, a requester that can only be acknoledged
  76.      using the mouse or some much too cryptic key combination (ugh!
  77.      been reading too much lyric lately?) 
  78.  
  79.        It seems that although appearance of these system requesters
  80.      has been improved in Kickstart 2.0 over 1.3, it wasn't nearly
  81.      enough. Close, but no banana...  
  82.  
  83.  
  84.   2. Who and why    
  85.  
  86.        Especially Peter was very unhappy with the new style
  87.      requesters in 2.0 (he doesn't like the 1.3 version either) --
  88.      "They have redone the Workbench, it now looks slick and shiny,
  89.      but those requesters are about as awful as they could be", and
  90.      "the design of the new requesters has already improved quite a
  91.      bit -- compared to Kickstart 1.3. But yet they are not yet
  92.      state-of-the-art".  
  93.  
  94.        Having seen one of my earlier tools, "CR", that remapped the
  95.      requesters under 1.3 to something a bit more appealing to the
  96.      eye (and IMHO, kinda much more user friendly), he came up with
  97.      the idea of redesigning those dialog boxes.  
  98.  
  99.        In the beginning, I was not quite happy about rewriting my
  100.      code to suit his rather perfectionist ideas ("now leave two
  101.      pixels here, and don't forget that line of gray to the
  102.      right...") -- no idea how he's done it, but he finally got me to
  103.      the point to do him the favor.  
  104.  
  105.        So here's the result. Note that it is trimmed to fit the "new
  106.      look" of Workbench 2.0 (hires interlace -- any other resolution
  107.      will make it look a bit weird).  
  108.  
  109.  
  110.   3. What      
  111.  
  112.        Arq, abreviation for -- well, I forgot --, is a little utility
  113.      to improve the look and feel of system requesters under AmigaOS
  114.      2.0.  Or, as Peter put it: 
  115.  
  116.        "If you were ever used to those really professional
  117.      Custom-Requesters for KS 1.3 from mjl, you were missing those
  118.      under AmigaOS-2. Well -- here they are!" 
  119.  
  120.        Since 1.57, Arq features a sound interface -- any appearing
  121.      requester now may be accompagnied by some user-definable sound.
  122.  
  123.  
  124.      What
  125.  
  126.  
  127.      Page 3                         Arq                         Page 3
  128.  
  129.  
  130.      Please refer to the respective chapter for more information
  131.      about the sound interface.  
  132.  
  133.        Arq wedges into Intuition's AutoRequest(), EasyRequest() and
  134.      DisplayBeep() vectors (as well as CloseScreen(), but you won't
  135.      notice that one), and replaces each of those routines by our
  136.      artist's idea of a requester.  
  137.  
  138.        Note that the graphics are stored in fax-like compression
  139.      format. This means that you (a) won't be able to compress it
  140.      much further, (b) having several Arq requesters open on a plain
  141.      vanilla 68000 will slow down the system a bit.  
  142.  
  143.  
  144.   4. How to     
  145.  
  146.        Just "run arq" and enjoy the improved system messages. To stop
  147.      it, just send it a ^C via the "break" command (though I doubt
  148.      you'll ever want to quit it).  
  149.  
  150.        Under 2.0, you can control Arq with the Commodities Exchange
  151.      tool. You may freely enable, disable, or kill Arq. Also, when
  152.      you start Arq a second time, it will remove itself from the
  153.      system.  
  154.  
  155.        The main advantage of those requesters is (apart their look),
  156.      that we moved the strange combination of Left-Amiga-V and
  157.      Left-Amiga-B to the ESC and RETURN key, which makes life quite a
  158.      lot easier (no more knots in your fingers) -- though, of course,
  159.      those are working too.  
  160.  
  161.        Another possibility is to use the function keys, where F1
  162.      corresponds to the leftmost, F2 to the second, and so forth,
  163.      gadget -- that way you can answer requesters with more than two
  164.      buttons, like IconEdit's.  
  165.  
  166.        Though written with 2.0 in mind, Arq does work under 1.3 as
  167.      well -- but the layout will look a bit stretched in
  168.      non-interlace mode. We will come out with an adapted version
  169.      when the time is ripe (ie. bug me, and you'll probably get it
  170.      [sigh]).  
  171.  
  172.        Please also note that this command replaces some of the
  173.      library vectors in intuition.library -- restoring them is per
  174.      definitionem not a safe operation.  While this works most of the
  175.      time, you may witness wonderful things happening when there is
  176.      another tool wedged in after Arq. So please be careful.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.      How to
  187.  
  188.  
  189.      Page 4                         Arq                         Page 4
  190.  
  191.  
  192.   5. Sounding away     
  193.  
  194.        Instead of building the sound capability into Arq itself, we
  195.      chose to implement it following the client-server model:  a
  196.      sound playing server, as, for example the "upd" sound daemon by
  197.      Jonas Petersson will do all the hard work, giving you the
  198.      additional bonus of being able to play your favorite tunes from
  199.      your ARexx programs...  
  200.  
  201.        The following sound IDs are used, for the corresponding
  202.      requesters and DisplayBeep -- please refer to upd's
  203.      documentation how these work.  
  204.  
  205.           · warn_write_protected
  206.           · warn_insert_volume
  207.           · warn_delete
  208.           · warn_printer
  209.           · error_task_held
  210.           · error_read_write
  211.           · error_general
  212.           · warn_general
  213.           · query_general
  214.           · beep
  215.  
  216.  
  217.  
  218.   6. License      
  219.  
  220.        This material is © Copyright 1990 by Martin J. Laubach, Peter
  221.      Wlcek and René Hexel -- All rights reserved.   
  222.  
  223.        It may be distributed freely as long as the following
  224.      restrictions are met: 
  225.  
  226.        The distributor may charge a fee to recover distribution
  227.      costs. The fee for diskette distribution should not be more than
  228.      the cost to obtain the same diskette from Fred Fish.  
  229.  
  230.        The distributor agrees to cease distributing the programs and
  231.      data involved if requested to do so by the authors.  
  232.  
  233.        You may copy and distribute verbatim copies of the program's
  234.      executable code and documentation as you receive it, in any
  235.      medium, provided that you conspicuously and appropriately
  236.      publish only the original, unmodified program, with all
  237.      copyright notices and disclaimers of warranty intact and
  238.      including all the accompanying documentation, example files and
  239.      anything else that came with the original.   
  240.  
  241.        The author will not be liable for any damage arising from the
  242.      failure of this program to perform as described, or any
  243.      destruction of other programs or data residing on a system
  244.      attempting to run the program.  While I know of no damaging
  245.      errors, the user of this program uses it at his or her own
  246.  
  247.  
  248.      License
  249.  
  250.  
  251.      Page 5                         Arq                         Page 5
  252.  
  253.  
  254.      risk.   
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.      License
  311.  
  312.  
  313.      Page 6                         Arq                         Page 6
  314.  
  315.  
  316.   7. Acks and Naks    
  317.  
  318.           Amiga and AmigaDOS are trademarks of Commodore-Amiga, Inc.
  319.           ARexx by William S. Hawes.
  320.           Perfectionism by Peter Wlcek.
  321.           Sporting events, transportation and girls by
  322.                    the Beach Boys.
  323.           upd by Jonas Petersson.
  324.           Window centering code by Holger Gzella, with additional comments
  325.                    by Peter Cherna.
  326.  
  327.  
  328.   8. Postscript      
  329.  
  330.         We are not really happy yet with the imaginery for "?" and
  331.      "!". Should you have "THE" idea, please get in touch with any of
  332.      us...  
  333.  
  334.        Also, don't hesitate to yell when you've got graphics you'd
  335.      like to see in the next version.  
  336.  
  337.  
  338.   9. Reactions      
  339.  
  340.        If you have any comments, ideas what could or should be
  341.      improved, bug reports or just like to chat a bit, please feel
  342.      free to contact me at one of the following addresses... I just
  343.      *love* receiving mail! 
  344.  
  345.        FidoNet: 2:310/3.14 
  346.        Usenet:  mjl%alison@cbmvie.at 
  347.                 {cbmvax!cbmehq, mcsun!tuvie}!cbmvie!alison!mjl 
  348.  
  349.        Peter, the graphics and animation wizard, can be reached
  350.      2:310/42 in FidoNet.  
  351.  
  352.        Looking forward to reading from you, 
  353.  
  354.              mjl 
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.      Reactions
  373.  
  374.  
  375.      Page 7                         Arq                         Page 7
  376.  
  377.  
  378.   10. Road Map    
  379.  
  380.  
  381.  
  382.         1. Introduction     ....................................    2
  383.         2. Who and why   .......................................    2
  384.         3. What     ............................................    2
  385.         4. How to    ...........................................    3
  386.         5. Sounding away    ....................................    3
  387.         6. License     .........................................    4
  388.         7. Acks and Naks   .....................................    6
  389.         8. Postscript     ......................................    6
  390.         9. Reactions     .......................................    6
  391.         10. Road Map    ........................................    7
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.      Road Map
  435.  
  436.